---
title: Socrú
description: Conas Ultracite a shuiteáil i do thionscadal.
---

Is féidir Ultracite a shuiteáil le gach príomh-bhainisteoir pacáistí. Beidh Node.js v14.18+ ag teastáil uait (moltaithe: Node 18+) agus tionscadal le comhad `package.json`.

## Suiteáil

Is é an bealach is éasca le tosú ná script `init` Ultracite a rith, a shuiteálfaidh na pacáistí riachtanacha agus a shocróidh an comhad cumraíochta duit. I eolaire do thionscadail, rith:

```package-install
npx ultracite init
```

Féadfaidh tú na brataí seo a leanas a sholáthar don ordú `init` más mian leat:

| Bratach             | Cur síos                                         | Roghanna                                                                 |
|---------------------|--------------------------------------------------|-------------------------------------------------------------------------|
| `--pm`              | An bainisteoir pacáistí le húsáid.               | `pnpm`, `bun`, `yarn`, `npm`                                            |
| `--frameworks`      | Na frámaí le cumrú.                              | Scartha le camóg: `react`, `next`, `solid`, `vue`, `qwik`, `angular`, `remix`, `svelte` |
| `--editors`         | Na heagarthóirí le cumrú.                        | Scartha le camóg: `vscode`, `zed`                                        |
| `--agents`          | Na gníomhaireacha AI le cumrú.                   | Scartha le camóg: `vscode-copilot`, `cursor`, `windsurf`, `zed`, `claude`, `codex`, `kiro`, `cline`, `amp`, `aider`, `firebase-studio`, `open-hands`, `gemini-cli`, `junie`, `augmentcode`, `kilo-code`, `goose`, `roo-code`, `warp`, `droid` |
| `--hooks`           | Na hooks gníomhaire le cumrú.                    | Scartha le camóg: `cursor`, `claude`                                     |
| `--integrations`    | Comhtháthuithe breise le socrú.                  | Scartha le camóg: `husky`, `lefthook`, `lint-staged`                     |
| `--migrate`         | Uirlisí aistrithe le bhaint.                     | Scartha le camóg: `eslint`, `prettier` (bainfidh sé spleáchais, comhaid chumraíochta, agus socruithe eagarthóra) |
| `--skip-install`    | Seachain suiteáil na spleáchais.                 | (ní gá luach)                                                            |
| `--quiet`           | Cuir faoi chois spreagthaí idirghníomhaíocha agus aschur amhairc. | (ní gá luach, cumasaithe go huathoibríoch i CI)                          |

### Úsáid Ríomhchláraithe

Dó uirlisí a bhíonn ag teastáil ó Ultracite a ghlaoch go ríomhchláraithe (mar shampla CLIs scafála), is féidir leat an bhratach `--quiet` a úsáid chun na spreagaí idirghníomhaíocha agus an t-aschur amhairc a chur faoi chois:

```bash title="Terminal"
npx ultracite init --quiet --pm npm
```

Cumasaítear an bhratach `--quiet` go huathoibríoch nuair a shocraítear an athróg timpeallachta `CI` ar `true` nó `1`, rud a chuireann é oiriúnach do phipilíní CI/CD:

```bash title="Terminal"
CI=true npx ultracite init --pm npm
```

I mód ciúnais, déanfaidh Ultracite:
- Déanfaidh sé neamhaird de na spreagaí idirghníomhaíocha go léir
- Úsáidfidh sé réamhshocruithe réasúnta do gach rogha
- Cuirfidh sé ealaín ASCII, spinners, agus teachtaireachtaí log faoi chois
- Cruthóidh sé ach an chumraíocht chroí do Biome
- Scoirfidh sé go glan le cód 0 má éiríonn leis nó 1 má theipeann air

## Síneadh

Má tá tú ag úsáid Visual Studio Code, suiteáil an síneadh oifigiúil [Biome](https://marketplace.visualstudio.com/items?itemName=biomejs.biome), a cheadaíonn formáidiú/deisiú ar shábháil:

```bash title="Terminal"
code --install-extension biomejs.biome
```

Freisin, má úsáideann tú Tailwind CSS, moltar an síneadh [Tailwind CSS IntelliSense](https://marketplace.visualstudio.com/items?itemName=bradlc.vscode-tailwindcss) a shuiteáil don sórtáil ranganna agus leideanna:

```bash title="Terminal"
code --install-extension bradlc.vscode-tailwindcss
```